home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 6 / CU Amiga Magazine's Super CD-ROM 06 (1996)(EMAP Images)(GB)(Track 1 of 4)[!][issue 1997-01].iso / cucd / prog / gnu-c / include / stdio.h < prev    next >
C/C++ Source or Header  |  1995-05-03  |  12KB  |  375 lines
  1. /*-
  2.  * Copyright (c) 1990 The Regents of the University of California.
  3.  * All rights reserved.
  4.  *
  5.  * This code is derived from software contributed to Berkeley by
  6.  * Chris Torek.
  7.  *
  8.  * Redistribution and use in source and binary forms, with or without
  9.  * modification, are permitted provided that the following conditions
  10.  * are met:
  11.  * 1. Redistributions of source code must retain the above copyright
  12.  *    notice, this list of conditions and the following disclaimer.
  13.  * 2. Redistributions in binary form must reproduce the above copyright
  14.  *    notice, this list of conditions and the following disclaimer in the
  15.  *    documentation and/or other materials provided with the distribution.
  16.  * 3. All advertising materials mentioning features or use of this software
  17.  *    must display the following acknowledgement:
  18.  *    This product includes software developed by the University of
  19.  *    California, Berkeley and its contributors.
  20.  * 4. Neither the name of the University nor the names of its contributors
  21.  *    may be used to endorse or promote products derived from this software
  22.  *    without specific prior written permission.
  23.  *
  24.  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  25.  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  26.  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  27.  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  28.  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  29.  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  30.  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  31.  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  32.  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  33.  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  34.  * SUCH DAMAGE.
  35.  *
  36.  *    @(#)stdio.h    5.17 (Berkeley) 6/3/91
  37.  */
  38.  
  39. #ifndef    _STDIO_H_
  40. #define    _STDIO_H_
  41.  
  42. #include <sys/cdefs.h>
  43.  
  44. #include <machine/ansi.h>
  45. #ifdef    _SIZE_T_
  46. typedef    _SIZE_T_    size_t;
  47. #undef    _SIZE_T_
  48. #endif
  49.  
  50. #ifndef NULL
  51. #define    NULL    0
  52. #endif
  53.  
  54. typedef long fpos_t;        /* Must match off_t <sys/types.h> */
  55.  
  56. #define    _FSTDIO            /* Define for new stdio with functions. */
  57.  
  58. /*
  59.  * NB: to fit things in six character monocase externals, the stdio
  60.  * code uses the prefix `__s' for stdio objects, typically followed
  61.  * by a three-character attempt at a mnemonic.
  62.  */
  63.  
  64. /* stdio buffers */
  65. struct __sbuf {
  66.     unsigned char *_base;
  67.     int    _size;
  68. };
  69.  
  70. /*
  71.  * stdio state variables.
  72.  *
  73.  * The following always hold:
  74.  *
  75.  *    if (_flags&(__SLBF|__SWR)) == (__SLBF|__SWR),
  76.  *        _lbfsize is -_bf._size, else _lbfsize is 0
  77.  *    if _flags&__SRD, _w is 0
  78.  *    if _flags&__SWR, _r is 0
  79.  *
  80.  * This ensures that the getc and putc macros (or inline functions) never
  81.  * try to write or read from a file that is in `read' or `write' mode.
  82.  * (Moreover, they can, and do, automatically switch from read mode to
  83.  * write mode, and back, on "r+" and "w+" files.)
  84.  *
  85.  * _lbfsize is used only to make the inline line-buffered output stream
  86.  * code as compact as possible.
  87.  *
  88.  * _ub, _up, and _ur are used when ungetc() pushes back more characters
  89.  * than fit in the current _bf, or when ungetc() pushes back a character
  90.  * that does not match the previous one in _bf.  When this happens,
  91.  * _ub._base becomes non-nil (i.e., a stream has ungetc() data iff
  92.  * _ub._base!=NULL) and _up and _ur save the current values of _p and _r.
  93.  */
  94. typedef    struct __sFILE {
  95.     unsigned char *_p;    /* current position in (some) buffer */
  96.     int    _r;        /* read space left for getc() */
  97.     int    _w;        /* write space left for putc() */
  98.     short    _flags;        /* flags, below; this FILE is free if 0 */
  99.     short    _file;        /* fileno, if Unix descriptor, else -1 */
  100.     struct    __sbuf _bf;    /* the buffer (at least 1 byte, if !NULL) */
  101.     int    _lbfsize;    /* 0 or -_bf._size, for inline putc */
  102.  
  103.     /* operations */
  104.     void    *_cookie;    /* cookie passed to io functions */
  105.     int    (*_close) __P((void *));
  106.     int    (*_read)  __P((void *, char *, int));
  107.     fpos_t    (*_seek)  __P((void *, fpos_t, int));
  108.     int    (*_write) __P((void *, const char *, int));
  109.  
  110.     /* separate buffer for long sequences of ungetc() */
  111.     struct    __sbuf _ub;    /* ungetc buffer */
  112.     unsigned char *_up;    /* saved _p when _p is doing ungetc data */
  113.     int    _ur;        /* saved _r when _r is counting ungetc data */
  114.  
  115.     /* tricks to meet minimum requirements even when malloc() fails */
  116.     unsigned char _ubuf[3];    /* guarantee an ungetc() buffer */
  117.     unsigned char _nbuf[1];    /* guarantee a getc() buffer */
  118.  
  119.     /* separate buffer for fgetline() when line crosses buffer boundary */
  120.     struct    __sbuf _lb;    /* buffer for fgetline() */
  121.  
  122.     /* Unix stdio files get aligned to block boundaries on fseek() */
  123.     int    _blksize;    /* stat.st_blksize (may be != _bf._size) */
  124.     int    _offset;    /* current lseek offset */
  125. } FILE;
  126.  
  127. #if 0
  128. __BEGIN_DECLS
  129. extern FILE __sF[];
  130. __END_DECLS
  131. #else
  132. #ifndef KERNEL
  133. __BEGIN_DECLS
  134. extern FILE **__sF;
  135. __END_DECLS
  136. #else
  137. #define __sF ((FILE **)(&(u.u_sF[0])))
  138. #endif
  139. #endif
  140.  
  141. #define    __SLBF    0x0001        /* line buffered */
  142. #define    __SNBF    0x0002        /* unbuffered */
  143. #define    __SRD    0x0004        /* OK to read */
  144. #define    __SWR    0x0008        /* OK to write */
  145.     /* RD and WR are never simultaneously asserted */
  146. #define    __SRW    0x0010        /* open for reading & writing */
  147. #define    __SEOF    0x0020        /* found EOF */
  148. #define    __SERR    0x0040        /* found error */
  149. #define    __SMBF    0x0080        /* _buf is from malloc */
  150. #define    __SAPP    0x0100        /* fdopen()ed in append mode */
  151. #define    __SSTR    0x0200        /* this is an sprintf/snprintf string */
  152. #define    __SOPT    0x0400        /* do fseek() optimisation */
  153. #define    __SNPT    0x0800        /* do not do fseek() optimisation */
  154. #define    __SOFF    0x1000        /* set iff _offset is in fact correct */
  155. #define    __SMOD    0x2000        /* true => fgetline modified _p text */
  156.  
  157. /*
  158.  * The following three definitions are for ANSI C, which took them
  159.  * from System V, which brilliantly took internal interface macros and
  160.  * made them official arguments to setvbuf(), without renaming them.
  161.  * Hence, these ugly _IOxxx names are *supposed* to appear in user code.
  162.  *
  163.  * Although numbered as their counterparts above, the implementation
  164.  * does not rely on this.
  165.  */
  166. #define    _IOFBF    0        /* setvbuf should set fully buffered */
  167. #define    _IOLBF    1        /* setvbuf should set line buffered */
  168. #define    _IONBF    2        /* setvbuf should set unbuffered */
  169.  
  170. #define    BUFSIZ    1024        /* size of buffer used by setbuf */
  171. #define    EOF    (-1)
  172.  
  173. /*
  174.  * FOPEN_MAX is a minimum maximum, and should be the number of descriptors
  175.  * that the kernel can provide without allocation of a resource that can
  176.  * fail without the process sleeping.  Do not use this for anything.
  177.  */
  178. #define    FOPEN_MAX    20    /* must be <= OPEN_MAX <sys/syslimits.h> */
  179. #define    FILENAME_MAX    1024    /* must be <= PATH_MAX <sys/syslimits.h> */
  180.  
  181. /* System V/ANSI C; this is the wrong way to do this, do *not* use these. */
  182. #ifndef _ANSI_SOURCE
  183. #define    P_tmpdir    "/t/"
  184. #endif
  185. #define    L_tmpnam    1024    /* XXX must be == PATH_MAX */
  186. #define    TMP_MAX        308915776
  187.  
  188. #ifndef SEEK_SET
  189. #define    SEEK_SET    0    /* set file offset to offset */
  190. #endif
  191. #ifndef SEEK_CUR
  192. #define    SEEK_CUR    1    /* set file offset to current plus offset */
  193. #endif
  194. #ifndef SEEK_END
  195. #define    SEEK_END    2    /* set file offset to EOF plus offset */
  196. #endif
  197.  
  198. #if 0
  199. #define    stdin    (&__sF[0])
  200. #define    stdout    (&__sF[1])
  201. #define    stderr    (&__sF[2])
  202. #else
  203. #define    stdin    (__sF[0])
  204. #define    stdout    (__sF[1])
  205. #define    stderr    (__sF[2])
  206. #endif
  207.  
  208. /*
  209.  * Functions defined in ANSI C standard.
  210.  */
  211. __BEGIN_DECLS
  212. void     clearerr __P((FILE *));
  213. int     fclose __P((FILE *));
  214. int     feof __P((FILE *));
  215. int     ferror __P((FILE *));
  216. int     fflush __P((FILE *));
  217. int     fgetc __P((FILE *));
  218. int     fgetpos __P((FILE *, fpos_t *));
  219. char    *fgets __P((char *, size_t, FILE *));
  220. FILE    *fopen __P((const char *, const char *));
  221. int     fprintf __P((FILE *, const char *, ...));
  222. int     fputc __P((int, FILE *));
  223. int     fputs __P((const char *, FILE *));
  224. int     fread __P((void *, size_t, size_t, FILE *));
  225. FILE    *freopen __P((const char *, const char *, FILE *));
  226. int     fscanf __P((FILE *, const char *, ...));
  227. int     fseek __P((FILE *, long, int));
  228. int     fsetpos __P((FILE *, const fpos_t *));
  229. long     ftell __P((const FILE *));
  230. int     fwrite __P((const void *, size_t, size_t, FILE *));
  231. int     getc __P((FILE *));
  232. int     getchar __P((void));
  233. char    *gets __P((char *));
  234. #if !defined(_ANSI_SOURCE) && !defined(_POSIX_SOURCE)
  235. extern int sys_nerr;            /* perror(3) external variables */
  236. #ifdef _USE_STATIC_LINKAGE
  237. /* don't use this here, as the shared library defines it, and we can't get
  238.  * at a character array there, only at a pointer array. So always use
  239.  * strerror() when you want what you normally accomplish with sys_errlist[] */
  240. extern char *sys_errlist[];
  241. #endif
  242. #endif
  243. void     perror __P((const char *));
  244. int     printf __P((const char *, ...));
  245. int     putc __P((int, FILE *));
  246. int     putchar __P((int));
  247. int     puts __P((const char *));
  248. int     remove __P((const char *));
  249. int     rename  __P((const char *, const char *));
  250. void     rewind __P((FILE *));
  251. int     scanf __P((const char *, ...));
  252. void     setbuf __P((FILE *, char *));
  253. int     setvbuf __P((FILE *, char *, int, size_t));
  254. int     sprintf __P((char *, const char *, ...));
  255. int     sscanf __P((const char *, const char *, ...));
  256. FILE    *tmpfile __P((void));
  257. char    *tmpnam __P((char *));
  258. int     ungetc __P((int, FILE *));
  259. int     vfprintf __P((FILE *, const char *, _VA_LIST_));
  260. int     vprintf __P((const char *, _VA_LIST_));
  261. int     vsprintf __P((char *, const char *, _VA_LIST_));
  262. __END_DECLS
  263.  
  264. /*
  265.  * Functions defined in POSIX 1003.1.
  266.  */
  267. #ifndef _ANSI_SOURCE
  268. #define    L_cuserid    9    /* size for cuserid(); UT_NAMESIZE + 1 */
  269. #define    L_ctermid    1024    /* size for ctermid(); PATH_MAX */
  270.  
  271. __BEGIN_DECLS
  272. char    *ctermid __P((char *));
  273. FILE    *fdopen __P((int, const char *));
  274. int     fileno __P((FILE *));
  275. __END_DECLS
  276. #endif /* not ANSI */
  277.  
  278. /*
  279.  * Routines that are purely local.
  280.  */
  281. #if !defined (_ANSI_SOURCE) && !defined(_POSIX_SOURCE)
  282. __BEGIN_DECLS
  283. char    *fgetline __P((FILE *, size_t *));
  284. int     fpurge __P((FILE *));
  285. int     getw __P((FILE *));
  286. int     pclose __P((FILE *));
  287. FILE    *popen __P((const char *, const char *));
  288. int     putw __P((int, FILE *));
  289. void     setbuffer __P((FILE *, char *, int));
  290. int     setlinebuf __P((FILE *));
  291. char    *tempnam __P((const char *, const char *));
  292. int     snprintf __P((char *, size_t, const char *, ...));
  293. int     vsnprintf __P((char *, size_t, const char *, _VA_LIST_));
  294. int     vscanf __P((const char *, _VA_LIST_));
  295. int     vsscanf __P((const char *, const char *, _VA_LIST_));
  296. __END_DECLS
  297.  
  298. /*
  299.  * This is a #define because the function is used internally and
  300.  * (unlike vfscanf) the name __svfscanf is guaranteed not to collide
  301.  * with a user function when _ANSI_SOURCE or _POSIX_SOURCE is defined.
  302.  */
  303. #define     vfscanf    __svfscanf
  304.  
  305. /*
  306.  * Stdio function-access interface.
  307.  */
  308. __BEGIN_DECLS
  309. FILE    *funopen __P((const void *,
  310.         int (*)(void *, char *, int),
  311.         int (*)(void *, const char *, int),
  312.         fpos_t (*)(void *, fpos_t, int),
  313.         int (*)(void *)));
  314. __END_DECLS
  315. #define    fropen(cookie, fn) funopen(cookie, fn, 0, 0, 0)
  316. #define    fwopen(cookie, fn) funopen(cookie, 0, fn, 0, 0)
  317. #endif /* !_ANSI_SOURCE && !_POSIX_SOURCE */
  318.  
  319. /*
  320.  * Functions internal to the implementation.
  321.  */
  322. __BEGIN_DECLS
  323. int    __srget __P((FILE *));
  324. int    __svfscanf __P((FILE *, const char *, _VA_LIST_));
  325. int    __swbuf __P((int, FILE *));
  326. __END_DECLS
  327.  
  328. /*
  329.  * The __sfoo macros are here so that we can 
  330.  * define function versions in the C library.
  331.  */
  332. #define    __sgetc(p) (--(p)->_r < 0 ? __srget(p) : (int)(*(p)->_p++))
  333. #if defined(__GNUC__) && defined(__STDC__)
  334. static __inline int __sputc(int _c, FILE *_p) {
  335.     if (--_p->_w >= 0 || (_p->_w >= _p->_lbfsize && (char)_c != '\n'))
  336.         return (*_p->_p++ = _c);
  337.     else
  338.         return (__swbuf(_c, _p));
  339. }
  340. #else
  341. /*
  342.  * This has been tuned to generate reasonable code on the vax using pcc.
  343.  */
  344. #define    __sputc(c, p) \
  345.     (--(p)->_w < 0 ? \
  346.         (p)->_w >= (p)->_lbfsize ? \
  347.             (*(p)->_p = (c)), *(p)->_p != '\n' ? \
  348.                 (int)*(p)->_p++ : \
  349.                 __swbuf('\n', p) : \
  350.             __swbuf((int)(c), p) : \
  351.         (*(p)->_p = (c), (int)*(p)->_p++))
  352. #endif
  353.  
  354. #define    __sfeof(p)    (((p)->_flags & __SEOF) != 0)
  355. #define    __sferror(p)    (((p)->_flags & __SERR) != 0)
  356. #define    __sclearerr(p)    ((void)((p)->_flags &= ~(__SERR|__SEOF)))
  357. #define    __sfileno(p)    ((p)->_file)
  358.  
  359. #define    feof(p)        __sfeof(p)
  360. #define    ferror(p)    __sferror(p)
  361. #define    clearerr(p)    __sclearerr(p)
  362.  
  363. #ifndef _ANSI_SOURCE
  364. #define    fileno(p)    __sfileno(p)
  365. #endif
  366.  
  367. #ifndef lint
  368. #define    getc(fp)    __sgetc(fp)
  369. #define putc(x, fp)    __sputc(x, fp)
  370. #endif /* lint */
  371.  
  372. #define    getchar()    getc(stdin)
  373. #define    putchar(x)    putc(x, stdout)
  374. #endif /* _STDIO_H_ */
  375.